Previous topicNext topic
 Link Technologies - LinkSOFT Documentation 
Help > Link Web Applications Portal > Integration > Integration Setup > Tax Monitoring System >
TMS Setup in LinkSOFT
The following must be set in LINKSOFT to enable the TMS:
  1. Tax Label
  2. Cashier and Customer "Tax Identification Number".
  3. Enable TMS Integration
  4. Setup ESDC or VSDC. Refer to the setup steps under "ESDC Setup" or "VSDC Setup".
Tax Setup
  1. Each tax type has a predefined tax label issued by TaxCore. Refer to Figure 1. This must be created under "Linkweb - Inventory - Tax Maintenance".
  2. Assign the tax code to the products under  "Linkweb - Inventory - Product Master"
Cashier and Customer TIN
  1. Cashier and Customer (Buyer) TIN must be stored in LinkSOFT. The TIN is transmitted to TaxCore and printed in the FISCAL invoice.
  2. Cashier TIN is saved under   "Linkweb - Point of Sale - User Options"
  3. Customer TIN is save under "Linkweb - Point of Sale - Customer Maintenance"
Enable TMS SDC integration. This is required for both ESDC and VSDC options.
  1. Log into Linkweb and navigate to "Integration - Integration Setup"
    1. Search for "FRCSSDC". This will load the integration setup for TMS. Refer to Figure 2.
      1. Click on the "Pencil Icon". This will open the "Edit Form".
      2. Tick "Active"
      3. Save. Click on the "Floppy Disk Icon". 
    2. Click on the "Grey Arrow" to expand into the details.
      1. Minimum Product Quantity - This is the minimum quantity that can processed under TMS. Sale will be prevented when the quantity is less than this value. Default value is 0.001 
      2. Allowed Tax Labels - These are the tax labels that is transited through TMS to identify the tax component. For example, the label for VAT is "A".  Users can add labels authorized by Tax Core to the list separated by a comma (CSV). 
ESDC Setup
  1. Install the SoftESDC or Inspur Device.
  2. Plug in the "Smart Card".
  3. Navigate to "Linkweb -  Point of Sale - Station Base Setup. Refer to Figure 3.
  4. Search for ESDC
    1. Click on the "Pencil Icon" to update ESDC Configurations.
      1. Tax Integration ESDC API URL - Enter the API URL in the "Flag Value"section.
        1. For Example, http://192.168.0.107:8180. "192.168.0.107" is the IP of the machine on which SoftESDC is installed or the IP of the Inspur of the device. "8180" is the port number.  
      2. Tax Integration Enabled - Enable ESDC integration, set the flag to "Yes".
      3. Tax Integration ESDC Secure Card PIN - Enter the "PIN"number of the smart card.  
        1. This is a 4 digit number provided by Taxcore.

VSDC Setup

VSDC is where the document is signed by the internet using certificates. VSDC setup requires the installation of three certificates:

  1. Root CA Certificate
  2. Issuing CA Certificate
  3. PFX Certificate or Smart Card Certificate. Refer to 1 and 2 below.

1. PFX Certificate (File based certifcate that does not require any physical hardware) 

  1. If you have chosen to use a "File Based Certificate" (PFX Certificate), use  this link to install your certificate. Once your file certificate is installed, go to step 3.
    1. Request for the "PFX Certificate" under "Location - Additional Certificates" to choose the VSDC - File-based certificate on the "TaxCore Web Portal".
    2. Install the certificate provided by TaxCore (Installing Dev-Pfx Certificate.pdf)
    3. Enter the VSDC details into the POS "Station Configuration" including the "PAC" code provided by TaxCore. This code should be in the email received from Tax Core.
      1. Tax Integration VSDC API URL - Enter the API URL in the "Flag Value"section. 
        1. For test or staging setup use - https://vsdc.staging.vms.frcs.org.fj  (This is different for each country. Refer to country specific documentation)
        2. For live or productions setup use - https://vsdc.vms.frcs.org.fj(This is different for each country. Refer to country specific documentation)
      2. Tax Integration VSDC Certificate Serial Number - Enter the serial number issued with the digital certificate for the company.
        1. Go to Personal Folder and into Certificates.
        2. Double click and open the certificate for VSDC.
        3. Go to the "Details" tab
        4. Copy the Serial Number into a "Notepad"
        5. Remove all "Spaces" from the number.
        6. Copy the Serial Number into the Configuration without spaces.
        7. Save. Click on the "Floppy Icon".
      3. Tax Integration Enabled - Enable VSDC integration, set the flag to "Yes". 
      4. Tax Integration PAC Code - The PAC Code is issued by the provider with the "PFX Certificate".
      5. Save. Users should be able to sign Invoices using VSDC without the need for a PIN or a Secure Card/Secure Card Reader.
    4. When using the Web Scheduler, the application Pool Identity should be set to startup using the user account where the PFX file is setup
    5. When using the Link Scheduled Service , setup the service account with the user where the certificate is installed
2. Secure Smart Card Setup (Requires a smart card reader) 
  1. If you have chosen to use the secure smart card then install then PKI Certificate Authority (CA) certificates on each client machine. Perform this step only if you are not using a "File Based Certificate (PFX)" explained in 1. above.
    1. Install the “Staging”  certificates for development or test environments.
    2. Install the “Production Certificates” for production setup.
    3. Follow the instructions at this link to install the certificates.
  2. Navigate to "Linkweb - Point of Sale - Station Base Setup". Refer to Figure 4. Search for VSDC
    1. Click on the "Pencil Icon" to update VSDC Configurations.
      1. Tax Integration VSDC API URL - Enter the API URL in the "Flag Value"section.
        1. For test or staging setup use - https://vsdc.staging.vms.frcs.org.fj  (This is different for each country. Refer to country specific documentation)
        2. For live or productions setup use - https://vsdc.vms.frcs.org.fj  (This is different for each country. Refer to country specific documentation)
      2. Tax Integration VSDC Certificate Serial Number - Enter the serial number issued with the digital certificate for the company.
        1. Go to Personal Folder and into Certificates.
        2. Double click and open the certificate for VSDC.
        3. Go to the "Details" tab
        4. Copy the Serial Number into a "Notepad" 3
        5. Remove all "Spaces" from the number.
        6. Copy the Serial Number into the Configuration without spaces.
        7. Save. Click on the "Floppy Icon".
      3. Tax Integration Enabled - Enable VSDC integration, set the flag to "Yes". 
Processing Sales
  1. Log into Link POS and "Start Point of Sales".
  2. Load the items and complete the transaction. This will process SDC. Refer to Figure 5.
    1. A fiscal invoice will print when the sales data has been transmitted.Refer to Figure 6.
    2. If SDC fails, users can "Retry" after a few second. Users will not be able to process the second sale if the current invoice is not signed.
      1. If the transaction fails at "Retry".
      2. Click on the "Exit and Log Off" button. This will close POS.
      3. Navigate to "Business Intelligence - Data View" and load the view for "Transactions Pending TMS Signature". This is show the pending transaction with the details to review and correction.
        1. Enable access for "Transactions Pending TMS Signature" view under Role Menu Access.
  3. Following transactions are signed with TMS: Both B2B and B2C transactions are included.
    1. Cash Sales
    2. Credit Sales
    3. Returns
    4. Reprint
    5. Quotations
    6. Full Lay -by
Figure 1 : TMS Tax Labels  
Figure 2: Enable FRCSSDC  

 
Figure 3: ESDC Configuration
 

Figure 4: VSDC Configuration

  
Figure 5: SDC Processing
Figure 6: Sample Fiscal Invoice